最后更新时间:2020年12月8日
功能介绍
地图操作指地图视图MapView提供一系列地图操作相关的函数(方法、事件等),包括地图基本操作、地图界面设置、地图截屏、地图背景设置、地图手势控制、地图手势监听、地图显示监听、地图动画控制、系统路径设置等。
地图操作与控制是最基本的功能之一,在地图显示的基础上实现,通常在地图浏览操作、地图显示控制,或结合业务需求与地图交互操作时应用。
开发者可通过该功能,实现移动端地图基本操作,包括地图的放大、缩小、旋转、倾斜、跳转(中心点+级别范围)、移动、复位,通常用于地图交互操作。
开发者可通过该功能,实现移动端地图视图中对缩放按钮、指北针、比例尺、MapGIS Logo四个地图界面控件的控制,可以控制其可见性、调整其显示位置,达到应用最佳显示效果。
开发者可通过该功能,实现移动端地图截屏,以图片的形式保存截取的地图。
开发者可通过该功能,设置移动端地图视图容器的背景,当地图缩放到范围较大时,地图周围是填充的背景图片,避免出现空白,同时起到美化作用。
开发者可通过该功能,实现移动端手势控制地图交互操作,支持多种交互手势,如滑动手势来移动地图,双指自由缩放来缩放地图、单指双击放大地图、双指单击缩小地图、双指旋转来旋转地图、双指竖直下滑倾斜地图。
开发者可通过该功能,监听地图手势事件,包括单击监听、双击监听、长按监听、触摸监听,在回调方法中返回坐标信息供用户使用。这四种手势事件在实际中应用的非常多,多用于交互操作,例如在地图上交互式绘制图形、交互式查询要素、交互式编辑要素等。
开发者可通过该功能,捕捉到地图显示变化如级别变化、旋转角度变化、中心点变化、位置变化、地图刷新、动画操作的各种状态与数值。
开发者可通过该功能,实现地图的系统库切换,即动态更换地图配图风格,包括地图的显示配置相应的颜色、符号、字体等。
功能接口
在地图显示之后,我们可以对地图进行各种操作、设置,实现的方法基本上都由com.zondy.mapgis.map.view.mapview程序包中的MapView类提供。
核心接口如下:
地图基本操作接口:
功能 | 接口 |
---|---|
放大 | zoomIn() |
缩小 | zoomOut() |
移动 | moveMap() |
旋转 | rotate() |
倾斜 | setSlopeAngle() |
跳转到点 | zoomToCenter() |
跳转到范围 | zoomToRange() |
复位 | restore() |
修改地图位置 | updatePosition() |
地图界面控制接口:
功能 | 接口 |
---|---|
控制缩放按钮可见性 | setMapZoomGesturesEnabled() |
控制指北针可见性 | setShowNorthArrow() |
设置指北针位置 | setNorthArrowPosition() |
控制比例尺可见性 | setShowScaleBar() |
设置比例尺位置 | setScaleBarPoistion() |
控制Logo可见性 | setShowLogo() |
设置Logo位置 | setLogoPoistion() |
地图截图功能接口:
功能 | 接口 |
---|---|
地图截屏 | getScreenSnapshot() |
地图出图 | getBitmap() |
地图背景设置接口:
功能 | 接口 |
---|---|
设置背景图片 | setBackGroundImage() |
设置背景颜色 | setBackGroundColor() |
地图手势控制接口:
功能 | 接口 |
---|---|
设置是否可用滑动手势——移动地图 | setMapPanGesturesEnabled() |
设置是否可用自由缩放——缩放地图 | setMapZoomGesturesEnabled() |
设置是否可用单指双击——放大地图 | setTwoFingerTapZooming() |
设置是否可用双指单击——缩小地图 | setDoubleTapZooming() |
设置是否可用双指旋转——旋转地图 | setMapRotateGesturesEnabled() |
设置是否可用双指竖直下滑——倾斜地图 | setMapSlopeGesturesEnabled() |
地图手势事件监听接口:
功能 | 接口 |
---|---|
地图单击事件 | setTapListener() |
地图双击手势事件 | setDoubleTapListener() |
地图长按手势事件 | setLongTapListener() |
地图触摸事件 | setTouchListener() |
地图显示事件监听接口:
功能 | 接口 |
---|---|
地图级别变化监听 | setZoomChangedListener() |
地图旋转角度变化监听 | setRotateChangedListener() |
地图中心点变化监听 | setCenterChangedListener() |
地图位置变化监听 | setCenterChangedListener() |
地图刷新监听 | setRefreshListener() |
地图动画监听 | setAnimationListener() |
地图动画接口:
功能 | 接口 |
---|---|
地图动画 | animatePosition() |
地图系统库设置接口:
功能 | 接口 |
---|---|
设置地图系统库路径 | setSystemLibraryPath() |